/*
 * Copyright [2022] [https://www.xiaonuo.vip]
 *
 * Snowy采用APACHE LICENSE 2.0开源协议，您在使用过程中，需要注意以下几点：
 *
 * 1.请不要删除和修改根目录下的LICENSE文件。
 * 2.请不要删除和修改Snowy源码头部的版权声明。
 * 3.本项目代码可免费商业使用，商业使用请保留源码和相关描述文件的项目出处，作者声明等。
 * 4.分发源码时候，请注明软件出处 https://www.xiaonuo.vip
 * 5.不可二次分发开源参与同类竞品，如有想法可联系团队xiaonuobase@qq.com商议合作。
 * 6.若您的项目无法满足以上几点，需要更多功能代码，获取Snowy商业授权许可，请在官网购买授权，地址为 https://www.xiaonuo.vip
 */
package vip.xiaonuo.biz.modular.file.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import org.springframework.web.multipart.MultipartFile;
import vip.xiaonuo.biz.modular.file.entity.BizFile;
import vip.xiaonuo.biz.modular.file.entity.BizFileManager;
import vip.xiaonuo.biz.modular.file.param.BizFileManagerAddParam;
import vip.xiaonuo.biz.modular.file.param.BizFileManagerEditParam;
import vip.xiaonuo.biz.modular.file.param.BizFileManagerIdParam;
import vip.xiaonuo.biz.modular.file.param.BizFileParam;
import vip.xiaonuo.biz.modular.fileManager.param.BizFileManagerPageParam;

import java.util.List;

/**
 * 记录活动文件Service接口
 *
 * @author xsl
 * @date  2024/08/14 16:32
 **/
public interface BizFileManagerService extends IService<BizFileManager> {

    /**
     * 获取记录活动文件分页
     *
     * @author xsl
     * @date  2024/08/14 16:32
     */
    Page<BizFileManager> page(BizFileManagerPageParam bizFileManagerPageParam);

    /**
     * 添加记录活动文件
     *
     * @author xsl
     * @date  2024/08/14 16:32
     */
    void add(BizFileManagerAddParam bizFileManagerAddParam);

    /**
     * 编辑记录活动文件
     *
     * @author xsl
     * @date  2024/08/14 16:32
     */
    void edit(BizFileManagerEditParam bizFileManagerEditParam);

    /**
     * 删除记录活动文件
     *
     * @author xsl
     * @date  2024/08/14 16:32
     */
    void delete(List<BizFileManagerIdParam> bizFileManagerIdParamList);

    /**
     * 获取记录活动文件详情
     *
     * @author xsl
     * @date  2024/08/14 16:32
     */
    BizFileManager detail(BizFileManagerIdParam bizFileManagerIdParam);

    /**
     * 获取记录活动文件详情
     *
     * @author xsl
     * @date  2024/08/14 16:32
     **/
    BizFileManager queryEntity(String id);

    /**
     * 引入底层文件上传（返回Id）
     *
     * @author xsl
     * @date  2024/08/14
     */
    String uploadReturnId(String engine, MultipartFile file);

    /**
     * 连表查询
     * @param bizFileManagerPageParam
     * @return
     */
    Page<BizFile> getPageVo(BizFileManagerPageParam bizFileManagerPageParam);


    /**
     * 获取公示文件分页
     * @param bizFileManagerPageParam
     * @return
     */
    Page<BizFile> getPageVoPublicity(BizFileManagerPageParam bizFileManagerPageParam);

    /**
     * 文件公示，站内信通知
     * @param bizFileParam
     */
    void publicityFile(BizFileParam bizFileParam);

    /**
     * 撤销公示
     * @param
     */
    void resetPub(List<BizFileManagerIdParam> bizFileManagerIdParamList);


    /**
     * 批量上传文件
     * @param files
     * @return
     */
    List<String> uploadList( MultipartFile[] files);

    /**
     * 批量上传文件(oss)
     * @param files
     * @return
     */
    List<String> uploadListByTencent(MultipartFile[] files);

    /**
     * 根据文件id查找管理器
     * @param fileId
     * @return
     */
    BizFileManager getByFileId(String fileId);

    /**
     * 获取文件地址
     * @param fileId
     * @return
     */
    String getFileUrl(String fileId);

}
